Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| apps:orage:start [2022/02/25 08:12] – [Orage - A calendar application] erxus | apps:orage:start [2023/07/02 08:04] (current) – Update Latest Release section kevinbowen | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ~~NOTOC~~ | ~~NOTOC~~ | ||
| - | {{ :xfce:xfce.gigolo.png?no link|}} | + | {{ :apps:orage:org.xfce.orage.png?no link|}} |
| ====== Orage - A calendar application | ====== Orage - A calendar application | ||
| Line 16: | Line 16: | ||
| * **[[#The exchange data window|The exchange data window]]** | * **[[#The exchange data window|The exchange data window]]** | ||
| * **[[#The preferences window|The preferences window]]** | * **[[#The preferences window|The preferences window]]** | ||
| + | * **[[# | ||
| * **[[#Latest Release|Latest Release]]** | * **[[#Latest Release|Latest Release]]** | ||
| * **[[#Source Code Repository|Source Code Repository]]** | * **[[#Source Code Repository|Source Code Repository]]** | ||
| Line 132: | Line 133: | ||
| * New: start an [[#The appointment window|appointment]] window for creating a new appointment for this day; | * New: start an [[#The appointment window|appointment]] window for creating a new appointment for this day; | ||
| * Duplicate: also start an [[#The appointment window|appointment]] window for creating a new appointment for this day. But do not start from scratch, but copy all values from the active row in the appointment list below. Note that if you do not have any rows selected from the event list, this button does not do anything (but gives a warning); | * Duplicate: also start an [[#The appointment window|appointment]] window for creating a new appointment for this day. But do not start from scratch, but copy all values from the active row in the appointment list below. Note that if you do not have any rows selected from the event list, this button does not do anything (but gives a warning); | ||
| - | * Delete: remove all selected appointments. There is no undo, so be carefull with this button! Before removing anything Orage asks for your verification. | + | * Delete: remove all selected appointments. There is no undo, so be carefull with this button! Before removing anything Orage asks for your verification; |
| * Back: show previous day; | * Back: show previous day; | ||
| * Today: show today; | * Today: show today; | ||
| Line 139: | Line 140: | ||
| * Find: activate the search tab; | * Find: activate the search tab; | ||
| * Close: close this window; | * Close: close this window; | ||
| - | * Dayview: start day list window; | + | * Dayview: start day list window. |
| === The tabs === | === The tabs === | ||
| Line 148: | Line 149: | ||
| * Todo: shows your active TODOs similarly than in the main calendar window. Only active ones are shown. If you want to see old TODOs, you need to find them in Search tab. | * Todo: shows your active TODOs similarly than in the main calendar window. Only active ones are shown. If you want to see old TODOs, you need to find them in Search tab. | ||
| * Journal: lists your notebook entries starting from certain date. Default start date is one year back and you can not change the default setting. | * Journal: lists your notebook entries starting from certain date. Default start date is one year back and you can not change the default setting. | ||
| - | * Search: enter a free text, which is searched from all the appointments. Usually the search is case independent, | + | * Search: enter a free text, which is searched from all the appointments. Usually the search is case independent, |
| === The appointment list === | === The appointment list === | ||
| Line 154: | Line 155: | ||
| The list shows all appointments satisfying the conditions and tab type. Scrollbars will appear if there are more lines or longer lines than what fits into the window. You can edit any appointment by double clicking the row. Each line has three fields: | The list shows all appointments satisfying the conditions and tab type. Scrollbars will appear if there are more lines or longer lines than what fits into the window. You can edit any appointment by double clicking the row. Each line has three fields: | ||
| - | * Time: the starting and ending times of the appointment (the format varies depending on tab and appointment). All times are always shown in your local timezone. It is possible to define special whole day appointments and they have a text "All day" instead of real start and end times. Rows appear in start time order. +sign in front of the time means that the appointment started on some previous day and correspondingly +sign at the end of the time means that appointment continues and ends later than the selected day. If the Event tab shows today, there are few extra formattings used: When the event has passed, it is overstriked. Currently active events are shown with blue colour and future events are bold. | + | * Time: the starting and ending times of the appointment (the format varies depending on tab and appointment). All times are always shown in your local timezone. It is possible to define special whole day appointments and they have a text "All day" instead of real start and end times. Rows appear in start time order. |
| - | * Flags: gives information about the appointment. If your appointment has a category which has been associated with a clour, flags field has that colour background. (Note that the explanations are visible as a hint when you move your cursor into the appointment list.) There are five flags in order: | + | * Flags: gives information about the appointment. If your appointment has a category which has been associated with a colour, flags field has that colour background. (Note that the explanations are visible as a hint when you move your cursor into the appointment list.) There are five flags in order: |
| * Alarm: what kind of action happens when alarm time passes. **n** means no alarm has been defined. **A** means that visible window is raised. **S** means that sound is played. (If both visual and sound alarm is defined, S is shown) | * Alarm: what kind of action happens when alarm time passes. **n** means no alarm has been defined. **A** means that visible window is raised. **S** means that sound is played. (If both visual and sound alarm is defined, S is shown) | ||
| * Recurrence: how often is that appointment happening. **n** means no repeating so that this event only happens once. **D** means daily repeat, **W** weekly, **M** monthly and **Y** yearly. | * Recurrence: how often is that appointment happening. **n** means no repeating so that this event only happens once. **D** means daily repeat, **W** weekly, **M** monthly and **Y** yearly. | ||
| Line 172: | Line 173: | ||
| </ | </ | ||
| - | The day list window shows all events that you have reserved for the next days. Default is to show 7 days, but you can change that and see up to 40 days at once. On top of the window you have menu and buttons to do actions. This is another form of your main activity window and more usefull than event list window if you want to find room for your new events or see your agenda and free time from longer | + | The day list window shows all events that you have reserved for the next days. Default is to show 7 days, but you can change that and see up to 40 days at once. On top of the window you have menu and buttons to do actions. This is another form of your main activity window and more usefull than event list window if you want to find room for your new events or see your agenda and free time from longer |
| === The button bar === | === The button bar === | ||
| Line 183: | Line 184: | ||
| * Forward: start listing one day later; | * Forward: start listing one day later; | ||
| * Refresh: redisplay the window; | * Refresh: redisplay the window; | ||
| - | * Close: close this window; | + | * Close: close this window. |
| === The parameters === | === The parameters === | ||
| Line 198: | Line 199: | ||
| ===== The appointment window ===== | ===== The appointment window ===== | ||
| - | The appointment window is used to add, edit and delete appointments. It is the most complex window in Orage, but most fields still have good default values and are not mandatory. It has button bar (All actions are also available in menus above the buttons) and three tabs controlling basic settings and alarms and recurrence settings. | + | The appointment window is used to add, edit and delete appointments. It is the most complex window in Orage, but most fields still have good default values and are not mandatory. It has button bar (all actions are also available in menus above the buttons) and three tabs controlling basic settings and alarms and recurrence settings. |
| === The button bar === | === The button bar === | ||
| Line 207: | Line 208: | ||
| * Save and close: like Save, but also closes the window. | * Save and close: like Save, but also closes the window. | ||
| * Revert: undo all changes done after previous save. Note that this button is active only after data has been changed. | * Revert: undo all changes done after previous save. Note that this button is active only after data has been changed. | ||
| - | * Duplicate: start creating new appointment and copy all values from the current activity into it. The new appointment is not created until you press //Save//. | + | * Duplicate: start creating new appointment and copy all values from the current activity into it. The new appointment is not created until you press Save. |
| - | * Delete: remove current appointment permanently from orage system. | + | * Delete: remove current appointment permanently from Orage system. |
| === The general tab === | === The general tab === | ||
| Line 258: | Line 259: | ||
| == Availability (Event) == | == Availability (Event) == | ||
| - | What kind of reservation is this. There are two possiblities: Free means that the action is not reserving the time and it is possible to schedule more appointments at the same time and respectively Busy means that nothing else can not be done at this time. Note that current version of Orage does not enforce these menings | + | What kind of reservation is this. There are two possibilities: Free means that the action is not reserving the time and it is possible to schedule more appointments at the same time and respectively Busy means that nothing else can not be done at this time. Note that current version of Orage does not enforce these meanings |
| == Completed (Todo) == | == Completed (Todo) == | ||
| Line 284: | Line 285: | ||
| In this tab, you define the alarm for the appointment. Orage supports three kinds of alarms: window, sound and procedure, but they all happen at the same time. It is possible to define only one alarm time for each appointment. To cause an alarm you need to do two things: You have to define alarm time and select alarm type. By default alarm happens 5 minutes before the appointment start time. Default alarm is Orage window without sound. | In this tab, you define the alarm for the appointment. Orage supports three kinds of alarms: window, sound and procedure, but they all happen at the same time. It is possible to define only one alarm time for each appointment. To cause an alarm you need to do two things: You have to define alarm time and select alarm type. By default alarm happens 5 minutes before the appointment start time. Default alarm is Orage window without sound. | ||
| - | Alarm time is set if any of the alarm timing numbers is non zero (in other words there is no special flag to set alarm; just define the time for it. This also prevents setting alarm to happen exactly at the appointment start/end time). You need explicitely | + | Alarm time is set if any of the alarm timing numbers is non zero (in other words there is no special flag to set alarm; just define the time for it. This also prevents setting alarm to happen exactly at the appointment start/end time). You need explicitly |
| == Alarm time == | == Alarm time == | ||
| Line 298: | Line 299: | ||
| Define the sound file to be played when the alarm fires. Leaving this empty disables sound alarm. Remember to define the actual play command in the preferences dialog. You should also test that your system can play the filetype you choose there. Simply start a terminal and test it using the command you specified and the sound file. | Define the sound file to be played when the alarm fires. Leaving this empty disables sound alarm. Remember to define the actual play command in the preferences dialog. You should also test that your system can play the filetype you choose there. Simply start a terminal and test it using the command you specified and the sound file. | ||
| - | By default alarm sound is played only once, but you can make it repeated by choosing the box next line. You can also define how many time it is repeated and what is the interval. Be carefull to set the interval longer than the length of the sound since orage does not wait for the previous sound to end before starting the next sound after the interval. Note that there is a silence button in visual alarms, so that you can stop the noise, but that only prevents the next play to happen, it does not interrupt currently playing alarm, which you should remember when using long lasting soundfiles. | + | By default alarm sound is played only once, but you can make it repeated by choosing the box next line. You can also define how many time it is repeated and what is the interval. Be carefull to set the interval longer than the length of the sound since Orage does not wait for the previous sound to end before starting the next sound after the interval. Note that there is a silence button in visual alarms, so that you can stop the noise, but that only prevents the next play to happen, it does not interrupt currently playing alarm, which you should remember when using long lasting soundfiles. |
| == Visual == | == Visual == | ||
| Line 382: | Line 383: | ||
| == Import == | == Import == | ||
| - | Enter the name of the file which you want to copy into Orage. You can do several files in a row by separating names with comma. After you have the file name in place, press //Save// and Orage reads the contents in. After the file has been imported, those appointmenst | + | Enter the name of the file which you want to copy into Orage. You can do several files in a row by separating names with comma. After you have the file name in place, press Save and Orage reads the contents in. After the file has been imported, those appointments |
| You can also import foreign files from the operating system using command line. This feature can be used to import ical files directly from the web by telling the browser (like Firefox) that the action is to start Orage. | You can also import foreign files from the operating system using command line. This feature can be used to import ical files directly from the web by telling the browser (like Firefox) that the action is to start Orage. | ||
| Line 388: | Line 389: | ||
| == Export == | == Export == | ||
| - | Enter the name of the file where you want Orage to write appointments. You can choose either all appoinments | + | Enter the name of the file where you want Orage to write appointments. You can choose either all appointments |
| == Archive == | == Archive == | ||
| Line 394: | Line 395: | ||
| You can either revert all archived appointments back to the main Orage file or force archiving. It is good idea to revert archive if you do exports since export does not look data from archive file. | You can either revert all archived appointments back to the main Orage file or force archiving. It is good idea to revert archive if you do exports since export does not look data from archive file. | ||
| - | === The orage files tab === | + | === The Orage files tab === |
| - | <figure "Orage exchange window - orage files tab"> | + | <figure "Orage exchange window - Orage files tab"> |
| {{ : | {{ : | ||
| </ | </ | ||
| Line 536: | Line 537: | ||
| ---- | ---- | ||
| - | ===== Dependencies | + | ===== Integration with Xfce panel clock ===== |
| - | For compiling | + | Orage can be opened by double mouse click to panel clock. Since from Xfce 4.18, panel clock properties can be used to enter orage command: |
| - | Furthermore you need, of course, a C compiler. | + | <figure " |
| + | {{ : | ||
| + | </ | ||
| - | Required dependecies: | + | Before |
| - | * Xfce development tools 4.16.0 or newer | + | < |
| - | * GTK 3.24.0 or newer | + | COMMAND=" |
| - | * GLib 2.52.0 or newer | + | |
| - | * intltool 0.35 or newer | + | |
| - | Optional dependencies: | + | More information about Xfce panel clock hidden settings can be found [[https://docs.xfce.org/ |
| - | * Libical 3.0 or newer | + | |
| - | * D-Bus 0.1 or newer | + | |
| - | * Libnotify 0.3.2 or newer | + | |
| [[|Back to Top]] | [[|Back to Top]] | ||
| Line 557: | Line 555: | ||
| ===== Latest Release ===== | ===== Latest Release ===== | ||
| - | {{rss> | + | {{rss> |
| + | |||
| + | [[https:// | ||
| - | * **[[http:// | + | * **[[https:// |
| [[|Back to Top]] | [[|Back to Top]] | ||